home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / bbb_v20.zip / BBB.DOC next >
Text File  |  1991-08-25  |  6KB  |  193 lines
  1.  
  2.                           -- BBB v2.0 --
  3.                      Brent's Batch Beautifier
  4.                       (c) 1991 Brent Ashley
  5.  
  6. With Brent's Batch Beautifier you can bemuse your buddies or 
  7. boggle your beau or boss with beautiful batches that simply 
  8. bulge with brilliance.  In conjunction with Brent's Environment 
  9. Tools (BET), you can create some REALLY powerful batches that 
  10. usually wouldn't be possible without a high-level compiled 
  11. language.
  12.  
  13. BBB sends screen control codes to your ANSI-compatible console 
  14. driver, thereby simplifying the process of making your batch files 
  15. attractive and colorful.  The commands supported by BBB allow:
  16.  
  17. o  Testing for ANSI-compatible console driver
  18. o  Cursor position saving, restoring and setting
  19. o  Display color and attribute setting
  20. o  Screen mode changes
  21. o  Box drawing with choice of fill and border
  22. o  Text display and string repeating
  23. o  Speaker beep and alarm
  24. o  Time, date, day of week
  25. o  Gas gauge meter
  26. o  Timed pause
  27. o  Keyboard input, flush, and stuffing
  28. o  DOS Environment editing
  29. o  Warm and cold reboot
  30. o  PrintScreen endable/disable
  31.  
  32. Most commands have both long and short forms, and commands can be 
  33. stacked in either or both forms to the end of the command line 
  34. (128 characters).  Each command is listed below with its short 
  35. form and syntax.  BBB examples can be found in DEMO.BAT.
  36.  
  37. NOTE: Remember to have an ANSI-compatible screen driver loaded in 
  38.       your CONFIG.SYS file!
  39.  
  40. Display Attributes:
  41. -------------------
  42. BOLD/!
  43. - Sets hi-intensity ON
  44.  
  45. UNDERLINE/_
  46. - Sets underline ON (monochrome adapter only)
  47.  
  48. BLINK/;
  49. - Sets flashing characters ON
  50.  
  51. REVERSE/*
  52. - Sets color to black on white
  53.  
  54. RESET/^
  55. - Resets all display attributes and sets color to white on black
  56.  
  57. COLOR/C Fore Back
  58. - Sets color to Fore on Back
  59. - choices for Fore and Back are:
  60.   BLACK/0 RED/1 GREEN/2 YELLOW/3 BLUE/4 MAGENTA/5 CYAN/6 WHITE/7
  61.  
  62. Cursor and Screen Control:
  63. --------------------------
  64. CLEAR/#
  65. - clears screen to current color and positions cursor at top left
  66.  
  67. CLREOL/)
  68. - clears to current color from cursor position to end of line
  69. - cursor remains at current position
  70.  
  71. SAVE/{
  72. - saves current cursor position
  73.  
  74. RESTORE/}
  75. - returns cursor to saved position
  76.  
  77. LOCATE/@ Row Col
  78. - Places cursor at position specified by Row and Col
  79.  
  80. MODE/M Mode
  81. - Changes screen mode (color/mono, 40/80 columns)
  82. - choices for Mode are: M40 M80 C40 C80
  83.  
  84. Text, String Output:
  85. --------------------
  86. SAY/? all text up to tilde~
  87. - displays text from first non-space character to tilde(~) at 
  88.   current cursor position and updates cursor position
  89.  
  90. STRING/$ string up to tilde~ Repeats
  91. - displays string number of times specified by Repeats
  92.  
  93. BOX/B Top Lft Bot Rgt Fill Border
  94. - saves cursor position, draws box from Top Lft to Bot Rgt, filled 
  95.   or empty, with specified border and returns cursor to original 
  96.   position.
  97. - Choices for Fill are: FILL/F EMPTY/E
  98. - Choices for Border are: SINGLE/S DOUBLE/D BLOCK/B
  99.  
  100. GAUGE/G Percent
  101. - displays 50-char shaded gas gauge bar filled to Percent level
  102.  
  103. ENTER/E
  104. - outputs a Carriage Return to the console (all other string commands
  105.   leave cursor at end of string without advancing to the next line)
  106.  
  107. TIME/T
  108. - displays time on format hh:mm:ss
  109.  
  110. DATE/D
  111. - displays date in format mm-dd-yy
  112.  
  113. Interactive features and Misc:
  114. ------------------------------
  115. ANSITEST
  116. - reports if ANSI.SYS is loaded.  The ANSI-detect routine is run 
  117.   whenever BBB is invoked and returns DOS errorlevel 255 if ANSI is
  118.   NOT available.  This command simply displays verification of ANSI 
  119.   availability.  There is no short form for the ANSITEST command.
  120. - execution ends at ANSITEST command - remaining command line ignored.
  121.  
  122. BOOT [COLD]
  123. - reboots machine.  Warm boot unless COLD is specified.
  124. - there is no short form for the BOOT command or its COLD parameter.
  125. - execution ends at BOOT command - remaining command line ignored.
  126.  
  127. PAUSE/P Seconds
  128. - if Seconds=0 waits until any key is pressed
  129.  
  130. FLUSH/F
  131. - flushes keyboard buffer of pending keystrokes
  132.  
  133. STUFF text up tilde~ (&=Return)
  134. - stuffs the specified text into the keyboard buffer to be retrieved  
  135.   by the next program (or DOS) that asks for input.  Any ampersand 
  136.   (&) characters in the string are replaced with carriage returns 
  137.   before stuffing.
  138.  
  139. BEEP/+
  140. - sounds speaker
  141.  
  142. ALARM/A Repeats
  143. - sounds three-note alarm number of times specified by Repeats
  144. - if Repeats=0 then sounds alarm until key is pressed
  145.  
  146. WEEKDAY/W
  147. - returns day of week as ERRORLEVEL (great for backup batches!)
  148. - 0 = Sunday ... 6 = Saturday
  149. - execution ends at WEEKDAY command - remaining command line ignored
  150.  
  151. INPUT/I EnvironmentVariableName
  152. - waits for user to input a string terminated by [ENTER] and assigns
  153.   string to the DOS environment variable specified
  154. - *NOTE*: if not enough environment space exists to allocate the 
  155.   variable, the variable will not be created and the error message
  156.   "BBB - not enough DOS environment space" will be displayed on
  157.   screen line 25.
  158.  
  159. QUERY/Q ValidString
  160. - waits for user to press a key in ValidString and returns DOS
  161.   ERRORLEVEL==position of key in string
  162. - beeps if invalid key pressed
  163. - execution ends at QUERY command - remaining command line ignored
  164.  
  165. UPCASE/U EnvironmentVariableName
  166. - forces environment variable to uppercase for easier comparisons
  167.  
  168. PRTSCR ON/OFF
  169. -  Enables or disables PrintScreen key.
  170.  
  171.                       -- Revision History --
  172.  
  173. 1.0 - first release - 5 Aug 1991
  174. 1.1 - add INPUT, ALARM, FLUSH, WEEKDAY, UPCASE 
  175. 1.2 - add ANSITEST and test for ANSI.SYS in init code, BOOT
  176. 2.0 - add cold boot, STUFF, PRTSCR 
  177.     - release with Brent's Environment Tools v1.0
  178.  
  179.                             -- Note --
  180.  
  181. BBB and BET are distributed as Freeware.  This means that while anyone can 
  182. use them at no cost, I retain the copyright.  
  183.  
  184. Both programs were written in Microsoft QuickBASIC and linked with 
  185. Crescent Software's PDQ link library.  Source code is available 
  186. for $10 per program ($20 total) from the address below.
  187.  
  188. Brent Ashley
  189. 8 Darnock Court
  190. Brampton, Ontario
  191. L6Z 2X3
  192. CANADA
  193.